Спринт 2/18 → Тема 3/6: Настройка окружения: Python, IDE, venv → Урок 5/6

Установка виртуального окружения (venv)

Как правило, на компьютере программиста живёт сразу несколько проектов. Одним проектам нужны одни версии библиотек, другим — другие.
Чтобы весь этот зоопарк разнообразных программ мирно уживался на одном компьютере — были придуманы «виртуальные окружения». Это своего рода «изолированные территории», отдельные виртуальные загончики для проектов.
В каждом загончике живёт один проект, и для него можно установить собственные настройки: указать нужную версию Python, установить необходимые библиотеки. Так можно одновременно работать со множеством проектов на одном компьютере, не переживая, что они будут мешать друг другу.

Создание виртуального окружения

Установка и настройка виртуального окружения для каждого проекта — норма жизни и современный стандарт, без этого разработчик — не разработчик.
Пару уроков назад вы создали папку Dev/, а в ней — проект first_project с файлом practicum.py. Создадим виртуальное окружение для этого проекта.
Запустите VSCode и через меню File → Open Folder... откройте папку first_project:
В терминале в VSCode откройте файл practicum.py удобным способом:
  • в главном меню выберите Terminal → New terminal;
  • наведите курсор на файл practicum.py, кликните правой кнопкой мыши и выберите пункт Open in integrated Terminal («Открыть во встроенном терминале»).
Если вы работаете под Windows — убедитесь, что в терминале запустился Git Bash.
Через терминал перейдите в папку first_project и разверните в ней виртуальное окружение:
BASH
# Папка, в которой должна быть выполнена команда .../Dev/first_project.

# Команда для Windows:
python -m venv venv
# Нет, нет, мы не опечатались, первый 'venv' — это часть команды (имя модуля),
# которая указывает, что нужно создать виртуальное окружение.
# А второй 'venv' — это имя для этого окружения.

# Команда для Linux и macOS:
python3 -m venv venv

# Python, запусти модуль venv, он установит виртуальное окружение.
# Назови это виртуальное окружение "venv".
# Имя можно задать любое, мы в примерах будем использовать "venv".
После выполнения этой команды в директории проекта появится папка venv (от virtual environment, «виртуальное окружение»), в ней хранятся служебные файлы. В этой же директории будут сохраняться все зависимости проекта, например библиотеки и модули.
Структура проекта будет такой:
Dev/
 └── first_project/
     ├── .vscode/         <-- Папка с настройками vscode (необязательно).
     ├── practicum.py     <-- Файл с вашей программой.
     └── venv/            <-- Папка виртуального окружения.

Активация виртуального окружения

Виртуальное окружение создано, теперь его нужно активировать.
Активировать виртуальное окружение нужно каждый раз перед началом работы с проектом. Для каждого проекта нужно создавать и активировать собственное виртуальное окружение. При активированном окружении проект будет работать внутри собственного «загончика», где ему будут доступны его зависимости и интерпретатор Python.
Активируйте виртуальное окружение проекта first_project. Для этого в VSCode, находясь в корневой директории проекта first_project, введите в терминал команду:
BASH
# Директория, в которой вы должны находиться ...Dev/first_project.

# Команда для Windows:
source venv/Scripts/activate

# Для Linux и macOS:
source venv/bin/activate

# Выполнить инструкции из файла activate во вложенной папке venv/Scripts.
❗ Во время прохождения курса вы часто будете вводить команды создания и активации виртуального окружения. Запишите их в блокнотик, на стикер или просто запомните.
+10 к скорости
Активировать виртуальное окружение можно и быстрее. Используйте для этого автодополнение (клавиша Tab). Получится вот такая комбинация:
BASH
# Для Windows:
sou -> Tab -> пробел -> v -> Tab -> s -> Tab -> a -> Tab -> Enter

# Для Linux или macOS:
sou -> Tab -> пробел -> v -> Tab -> b -> Tab -> a -> Tab -> Enter
После активации виртуального окружения в терминале появится уведомление, что вы работаете в виртуальном окружении: все команды будет предварять строка (venv):
BASH
# Строка для ввода теперь будет выглядеть так: 
(venv) ...$

# В зависимости от настроек вашей системы 
# строка ввода может выглядеть чуть иначе.
# Например, так:
(venv) username@computer-name /directory-name$
# username — имя пользователя.
# computer-name — название компьютера.
# /directory-name — текущая директория.
Виртуальное окружение для проекта first_project запущено! Теперь все команды, которые вы введёте в терминал, будут выполняться в этом окружении.
💡 Далее по курсу все команды, которые начинаются в листингах с (venv)...$, выполняйте с активированным виртуальным окружением. Сами символы (venv)...$ вводить не надо. Это просто напоминание, что окружение создано и активировано.
Деактивировать виртуальное окружение можно командой:
BASH
(venv)...$ deactivate
Можно даже уничтожить виртуальное окружение, просто удалив папку /venv из корневой папки проекта.

Выбрать нужный питон для окружения

На вашем компьютере может быть установлено несколько версий Python. Команда python -m venv venv для Windows и python3 -m venv venv для macOS/Linux поместит в виртуальное окружение версию Python, установленную для системы по умолчанию.
Но иногда требуется использовать другую версию Python. Например, в случаях, когда вам нужно запустить проект, для которого код был написан, скажем, под версией 3.7, а по умолчанию у вас установлена версия 3.9.
Чтобы проект запустился без ошибки, нужно создать виртуальное окружение, указав нужную версию Python.
В разных операционных системах это делается по-разному.
Windows
За переключение между версиями в Python на Windows отвечает утилита Pylauncher. Она устанавливается в операционную систему вместе с интерпретатором.
Чтобы посмотреть список установленных версий Python на компьютере, нужно ввести в терминал команду:
BASH
py -0
В результате выполнения команды выведется список доступных версий Python, например такой:
Чтобы узнать, какая версия установлена версией по умолчанию, понадобится команда:
BASH
python --version
Например, такой вывод означает, что версией по умолчанию установлена 3.9, именно её активирует команда python -m venv venv:
Предположим, что вам нужно поработать не с версией по умолчанию, а с версией 3.7, которая установлена в системе. С этой задачей справится команда:
BASH
py -3.7 -m venv venv
Linux
Чтобы увидеть список всех установленных в систему версий Python, нужно ввести в терминал команду:
BASH
sudo ls -ls /usr/bin/python*
Если вы хотите использовать в работе определённую версию Python, добавьте к команде создания виртуального окружения номер этой версии. То есть виртуальное окружение с версией Python по умолчанию создаётся командой:
BASH
python3 -m venv venv
А с версией 3.8 командой:
BASH
python3.8 -m venv venv
macOS
Чтобы увидеть список всех установленных в систему версий Python, нужно ввести в терминал команду:
BASH
brew search python
Версию Python, установленную по умолчанию, покажет команда:
BASH
python3 --version
Для создания виртуального окружения с определённой версией Python, нужно установить ссылку на эту версию в системе. Для этого необходимо деактивировать ссылку к текущей версии командой:
BASH
brew unlink python@3.9
А затем указать необходимую версию:
BASH
brew link python@3.7
Теперь вы можете выбирать нужную версию Python и настраивать виртуальное окружение для любого своего проекта. Всё будет в своих персональных «загончиках»!